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Page 1: Introduction 

One of the biggest advantages of using C++ is templates. Templates were designed from the ground up 
to allow developers to write one function to handle many different types of parameters. Because C++ is 
a strongly typed language (ie: You must declare a variable before you can reference it), each and every 
function you create must specify the data type of each parameter it accepts and also the data type of 
its return value, such as int, bool, char, string, etc. 

Page 2: Understanding function overloading 

To understand where templates have come from though, you must first understand function 
overloading. Let's say for an example, that we wanted to create a function that would work with 
numeric values and return the average of those values. The function should be able to accept integers, 
floats and doubles. To accomplish this, we could create three functions to handle each different type of 
numeric value: 



To work with integers: 



int GetAverage (int numl, int num2, int numS) 



{ 



return static_cast<int> ( {niiml + nuin2 + num3) / 3) ; 



} 



To work with floating point values: 



float GetAverage {float numl, float num2, float numS) 
{ 



return static_cast<f loat> { (numl + nuin2 + numS) / 3) ; 



} 



To work with double values: 
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double Get Average (double numl, double nuin2, double num3) 
{ 

return static_cast<double> ( (numl + num2 + numS) / 3) ; 



) 



Then, whenever we called the GetAverage() function from our progrann, the C++ compiler would decide 
which function it should call based on the types of the parameters passed to that function. If an un- 
handled type, such as long was passed to the function, then the compiler would automatically cast it to 
the type that it most closely resembled (In this case, long would be converted to int). 



As you can see, we end up with three functions that do exactly the same thing. This is bad, because it 
creates a lot of redundant code, and our executable file will be bigger than it needs to be. 



There has to be a better way... and there is... it's called a template. 

Page 3: The template 

If you've ever programmed with Visual Basic, then you will probably be familiar with the variant data 
type. The variant is type-less in a sense that it allows a variable to be declared as a wild card and 
contain any type of data. 

Well, C++ doesn't allow this, and in many ways, templates can substitute for variants. To fully 
understand templates, let's start with an example. Open your favourite C++ IDE, and create a new 
project with two files: main.h and main.cpp. Into main.h, enter the following code: 



template<class T> T GetAverage(T numl, T num2, T num3); 



This is our template declaration. It looks like a regular function declaration and its purpose is exactly 
the same as any functions declaration: to let the compiler know that the template exists. Let's break 
down the templates declaration: 



template<class T> 



This section of the declaration tells the C++ compiler that we are defining a new template definition. 
Between the angled brackets, we are declaring a new type identifier, T. This tells the compiler to create 
a new type identifier called T. T will hold the type of variable that this template will be working with. 
The type of variable is decided from the types of each of the parameters passed to the function. If, for 
example numl, num2 and num3 were of type int, then T would be an int. 



T GetAverage(T numl, T num2, T num3); 



Let's step away from templates for a moment and imagine the following function declaration: 



int GetAverage (int numl, int num2, int num3); 
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Looks similar to our template definition right? Well it is. The T is acting as the type of variable that the 
template will work with. The template doesn't know what type of variable it can accept yet. As long as 
the variables passed to the function can handle the operator+ and operator/ (can be added with/divided 
by other variables) functions (which all numeric types can), then the function will work successfully and 
will return the sum of all of the numbers divided by three (the average). 

Page 4: The template (contd.) 

Now that we have created the function declaration for our template, lets create the actual code for it. In 
main.cpp, enter the following code: 

#include <iostreain> 
#include "main.h" 
using namespace std; 

template<class T> T GetAverage(T nunl, T num2, T numS) 
{ 

return static_cast<T> ( {numl + num2 + num3) / 3); 
} 

int mainO 
{ 

int X = 10; 
int y = 20; 
int z = 30; 

int returnValue = GetAverage (x, y, z) ; 

cout « "Returned " « returnValue « endl << endl; 

return 0; 

} 

We start out by #including the iostream head filer (so we can output to the screen) and our main.h 
header file, which contains the declaration of our template. 

Next, we have the full code for our template: 

template<class T> T GetAverage {T numl, T num2, T num3) 
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{ 

return static_cast<T> ( {numl + num2 + num3) / 3); 



The first line is exactly the same as the templates declaration In main.Ti. Our template only contains one 
line, which calculates the average of the three variables passed in as parameters, and returns that 
value. 



Our template uses the static_cast<>() function to make sure that the return value is also of type T. 
This is necessary, because most of the time, when finding the average, the result will contain a decimal 
point and mantissa. If, for example, we passed three int values to the template, then we would expect 
an int to be returned, and not a double, for example. That's what the statlc_cast<>() function is 
responsible for handling. 



Note: The static_cast<>() function is actually a template. The value between the angled brackets tells 
the template what the return type of the template should be. 



Before moving onto the next section, try changing the types and values of x, y, and z. The return type 
of the template will be the same as the values passed to it! 

Page 5: A simple class template 

Templates can also be used to create classes. Class templates stem from the same principles as normal 
templates, and are used in exactly the same way. A class template allows a developer to create classes 
whose constructor, destructor and functions can accept different types of values, just like a function 
template. 



To create a class template, create a new C++ project and add two files: dasstemplate.h and 
classtemplate.cpp. Into dasstemplate.h, enter the following code: 



template<typename T> class MyClass 



public: 

MyClass(T x = 0, T y = 0, T z = 0) : nl(x) , n2(y), n3(z) {} 
T GetAverage ( ) ; 
private: 
T nl; 



T n2; 
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T n3; 

}; 

This code might look a little confusing at first, but allow me to explain it. Notice how we have defined 
the entire class in the header file this time, and not just the declaration like we did for the function 
template? 

Firstly, we have the class declaration: 

template<typename T> class MyClass 

A class template declaration is a bit different to a function template declaration. Firstly, between the 
angled brackets, we are creating a type identifier. We have used "typename" instead of "class" here, 
but they are interchangeable. 

Next, we have the "class" keyword followed by the name of the class, "MyClass". The class can be 
called anything you like, but we will use "MyClass" in this example. 

{ 

public: 

MyClass(T x = 0, T y = 0, T z = 0) : nl(x), n2 (y) , n3(z) {} 

T GetAverage ( ) ; 

private : 

T nl; 

T n2; 

T n3; 

}; 

Following the template class's declaration, we have its default constructor and one function named 
GetAverageO which takes no parameters and returns a value of type T. 

Notice that our constructor is accepting three variables of type T, all with a default value of zero. The 
constructor assigns these values to our private member variables (of type T) nl, n2 and n3 
respectively. These private variables are simply used to hold the values of the variables passed in and 
can't be accessed. 

Page 6: A simple class template (contd.) 

Open classtemplate.cpp and enter the following code: 
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#include <iostream> 
#include "classtemplate.h" 
using namespace std; 

template<typenaine T> T MyClass<T>: : GetAverage ( ) 
{ 

return static_cast<T>( (nl + n2 + n3) / 3) ; 
) 

int main{) 
{ 

MyClass<int> mc {1, 2, 3); 

cout « "Return value is: " « mc. GetAverage () « endl « endl; 

return 0; 

} 

Lets start by describing the GetAverage function of the MyClass class. 

teinplate<typename T> T MyClass<T>: : GetAverage { ) 
{ 

return static_cast<T> ( (nl + n2 + n3) / 3); 
} 

Firstly, our class function is declared as a tennplate using the template<typenanne T> keywords, 
meaning that our class function has just one type identifier, T. 

T MyClass<T> : : GetAverage ( ) 

Secondly, our class function returns a value of type T. Notice that the class name, "MyClass", is 
followed by our type parameter, T. This tells the C++ compiler that our function will handle values of 
type T. 

The code for our class function is similar to the code for our template function, from above: 
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return static_cast<T> ( (nl + n2 + n3) / 3) ; 



All of the three privately declared variables, nl, n2 and n3 are summed up, divided by three and then 
returned as a variable of type T. 

Page 7: Instantiating the class 

Before we can use our class template, we must create an instance of it within our main function: 



MyClass<int> mcd, 2, 3); 

cout « "Return value is: " « mc . GetAverage ( ) « endl « endl; 



On the first line, we are creating a new instantiation of our class template. Between the angled 
brackets, we are telling the C++ compiler that our class will be handling integer (int) type variables. 
This is a mandatory inclusion and the compiler will complain if you leave It out. The new instantiation of 
our "MyClass" template is called "mc". We are passing three values to the default constructor, which will 
be stored as the private variables nl, n2 and n3. In our examples, these variables will be of type int, 
meaning T will take on the role of an integer. 



On the second line above, we simply call the GetAverage() function of our class template, just like we 
would with any class, outputting the value returned from the function, which looks something like this: 



Return value is: 2 

Page 8: Behind the scenes 

You might be wondering just exactly what goes on under the hood when a C++ class template is 
instantiated. 



Firstly, the C++ compiler creates an instance of the template and stores it oh the stack. Because our 
class template passes integer values to Its constructor, the compiler creates an instance of our class (on 
the stack) that can work with variables of type int. This leads us to an important point: The class 
template itself doesn't actually do any of the code processing. It simply creates a new instance of the 
class and its encapsulated functions for the type of variable that it is dealing with, such as int, float, 
char, string, etc. If an instance of a class for a specific variable type has already been created, the 
compiler will use that class to create the new Instance. When the program ends, the class template and 
all of its copies are popped off the stack. Just remember that the template is only responsible for 
creating an instantiation of the class for the type of variable that is required by the program code and 
doesn't actually get executed. 

Page 9: Conclusion 

Templates provide the C++ developer with a whole new level of power, flexibility and robustness. 
Templates play a big role in several C++ libraries including the standard template library (STL) and the 
active template library (ATL), and fully understanding and utilizing templates where they are needed 
can increase the speed, cleanliness and re-useability of your code. 



We have just briefly touched on templates in this article. If you want to know more about templates, 
take a look at the links and books shown below. 
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For more great programming articles, please visit http://www.devarticles.com. If you have an opinion 
or question about this article, then please post it at the devArticles developer forum, which is located at 
http://www.devarticles.com/forum 
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